home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / packet / terminal / pescav1d / pescador.eng < prev    next >
Text File  |  1996-05-19  |  38KB  |  937 lines
  1.  
  2.                    ▒▒▒▒▒▒                         ▒
  3.                    ▒     ▒                        ▒
  4.                    ▒     ▒  ▒▒   ▒▒   ▒▒   ▒▒   ▒▒▒  ▒▒   ▒▒
  5.                    ▒     ▒ ▒  ▒ ▒  ▒ ▒  ▒ ▒  ▒ ▒  ▒ ▒  ▒ ▒  ▒
  6.                    ▒▒▒▒▒▒  ▒  ▒ ▒    ▒       ▒ ▒  ▒ ▒  ▒ ▒
  7.                    ▒       ▒▒▒▒ ▒▒▒  ▒     ▒▒▒ ▒  ▒ ▒  ▒ ▒
  8.                    ▒       ▒       ▒ ▒    ▒  ▒ ▒  ▒ ▒  ▒ ▒
  9.                    ▒       ▒  ▒ ▒  ▒ ▒  ▒ ▒  ▒ ▒  ▒ ▒  ▒ ▒
  10.                    ▒        ▒▒   ▒▒   ▒▒   ▒▒   ▒▒   ▒▒  ▒
  11.  
  12.  
  13.                          Pescador Version 1.0 (Beta)
  14.                  Beta Level #00148 19/05/96 (Expiration 07/96)
  15.                        by Pedro E. Colla (LU1BUV) 1996
  16.  
  17.                 Packet Forward capture thru channel monitoring
  18.  
  19.               (or ... The dog who is terribly at singing tangos!)
  20.  
  21.  
  22.  
  23.  
  24. -------------------------------------------------------------------------------
  25.                    Just in case it's not quite clear by now
  26.  
  27.                           THIS IS A BETA VERSION LEVEL
  28.  
  29. BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA BETA
  30. -------------------------------------------------------------------------------
  31.  
  32. Introduction
  33. ------------
  34.  
  35.    This program could get a forward out of the packet AX.25 net thru the
  36. bare monitoring of the channel traffic, that is, without a physical connection
  37. with a BBS, even without any transmision at all.
  38.  
  39.    The operation is based on the capture of the forward between two any other
  40. BBSs on the channel.
  41.  
  42.    The methods and algorithms used are far from perfect, the scope and
  43. limitations of the program will be reviewed in detail later on this document.
  44.  
  45.    At the present stage the program implements a CONCEPT and this implementation
  46. is yet to be refined to be trustworthy for the day to day operations; all
  47. configuration options as well as it's algorithms are subject to change driven
  48. by the field evaluation I receive or do myself.
  49.  
  50. Audience
  51. --------
  52.  
  53. This program is targeted towards sysops and advanced stations who look
  54. forward to improve the efficiency of our saturated packet channels.
  55.  
  56. It's assumed a basic familiarity with the radio amateur packet network
  57. basic operational principles to being able to have some success with this
  58. program.
  59.  
  60. If the program purpose sounds like chinese to you perhaps it's because this
  61. program isn't for you.
  62.  
  63.  
  64. About this document
  65. -------------------
  66.  
  67. This document is a quick and dirty translation of the Spanish version
  68. (PESCADOR.DOC) intended to ease the lives of the non-Spanish spoken
  69. audience this program might have.
  70.  
  71. This is not the reference documentation for the program, the best update
  72. effort is directed only to the Spanish version; further update of this
  73. English version will be done on a 'best can do' basis.
  74.  
  75. Requirements
  76. ------------
  77.  
  78.      - Hardware
  79.           PC compatible 386+, 640K RAM, some free disk space.
  80.  
  81.      - Software
  82.           DesqView, Windows 3.1 u OS/2 2.1
  83.           Packet Switch G8BPQ 4.09a+ o TFPCX 2.10 (see configuration).
  84.           BBS o PMS enabled to work under the G8BPQ's switch and/or accept
  85.              a W0RLI formatted file import.
  86.  
  87.  
  88. Mail in Packet Radio
  89. --------------------
  90.  
  91.    To fully understand the PURPOSE and SCOPE of this program is necessary
  92. to understand the procedures who regulates the mail forward on the packet
  93. network.
  94.  
  95.    On a daily basis, the mail traffic flows thru the packet network using
  96. multiple forward paths between the nodes (BBS) on the net.
  97.  
  98.    Each forward session is implemented using a wide variety of links such
  99. as HF, VHF, UHF, Satellites, Phone and even other networks.
  100.  
  101.    Two information types are basically being transported, bulletins and
  102. private mail; both widely differs in their handling.
  103.  
  104.    The private mail jumps between any two net nodes following a route
  105. defined by the destination of the mail; usually each net node will forward
  106. the mail to the next step in the process based on the good or bad route
  107. selection that this node sets for a given destination; usually too, the
  108. private mail is cleaned from an intermediate node once it has been forwarded.
  109.  
  110.    Bulletins, in the other hand, flows radially from the node who originates
  111. it and without a predefined destination. To improve the definition of the
  112. forward characteristics the bulletins are addressed to 'groups' such as
  113. @LUNET or @WW; each group in turn has a 'topic' such as FBB@WW.
  114.  
  115.    In general the group drives the forward path of a given bulletin and
  116. the routing it will be under, but other considerations might apply at the
  117. node level such as the individual size of the bulletin, the actual content
  118. of it under the sysop judgement or the node who originates it.
  119.  
  120.    When propataged, each node will forward a bulletin typically with all
  121. the other nodes it has forward with, some selection based on the 'group'
  122. name must be expected based on the target node forward profile.
  123.  
  124.    As a difference with the private mail, the bulletin could be forwarded
  125. several times (as many as other nodes forward with us) and would be left
  126. resident on the node until some sort of maintenance purge process clean it.
  127.  
  128.    Because of this difference, the bulletin taxes the net bandwidth
  129. as a proportion of the nodes actually receiving it (plus the final users
  130. who reads it); the traffic is then VERY SIGNIFICATIVE.
  131.  
  132.  
  133. Purpose and Scope
  134. -----------------
  135.  
  136.    It's very important to understand the PURPOSE and SCOPE of this program
  137. before to decide to use it.
  138.  
  139.    The PURPOSE of this program is to take benefit out of the fact that in
  140. crowded areas it's likely to found several forwarding nodes with good
  141. radiolectrical visibility between them performing redundant mail forwarding.
  142.  
  143.    In such cases the traffic flows thru the network and could be monitored
  144. by the other stations simultaneously in the channel (althrough not activerly
  145. performing forward themselves).
  146.  
  147.    If thru this monitoring a fraction of the mail volume could be captured
  148. then the forward will be avoided later.
  149.  
  150.    To achieve this the program monitor the traffic between any two nodes
  151. in pairs (up to 5 of those pairs are allowed) and when a mail forward between
  152. them is detected as many messages of that forward are captured; the captured
  153. messages are later formatted as an import file to be processed by the
  154. local node (BBS/PMS) itself.
  155.  
  156.    When the captured messages are, later, offered to the local BBS/PMS
  157. they will be reported as already forwarded and the forward over the air
  158. wouldn't take place.
  159.  
  160.    The SCOPE of this program is to capture a big fraction as possible of
  161. the whole mail traffic; this process isn't perfect and only a fraction
  162. of the whole message flow will be captured.
  163.  
  164.    It's important to understand some basic limitations the program will
  165. show:
  166.  
  167.    - The link being monitored operates as an AX.25 connected circuit,
  168.      both could use the protocol to overcome link errors; a pasive
  169.      monitoring station couldn't use those those methods. Link errors
  170.      at the monitoring stations not occurring at the receiving stations
  171.      at the same time (thus activating the protocol error recovery
  172.      procedures) will hit the whole piece of mail where the error
  173.      occurs.
  174.  
  175.    - Exception given for trivial interceptions (i.e. monitoring ourselves)
  176.      there will be relative difference on how the monitored stations are
  177.      receiving themselves and how, at the same time, we receive both
  178.      stations. This effect is noticeable both in terms of signal strenght
  179.      or the impact of a colision with a 4th station operating in the
  180.      same channel.
  181.  
  182.    - The widely used method of forward the messages as a compressed batch
  183.      (i.e. FBB) optimizes the link between the stations making the forward
  184.      but inherently makes the monitoring harder.
  185.      Usually some error during the reception of a batch will hit several
  186.      messages.
  187.  
  188.    - At the same time, the partial transmision of messages (such as the
  189.      offset recovery method used by the FBB BBS) makes extremely hard
  190.      for those messages to be captured; in fact this program skips those
  191.      messages.
  192.  
  193.    Some of the above factors are compensated by algorithms imbedded in the
  194. program thru the usage of some 'fuzzy logic', the compensation isn't
  195. complete though.
  196.  
  197.    Due to those factors THIS PROGRAM MUST NOT BE UNDERSTOOD AS A REPLACEMENT
  198. FOR THE CONVENTIONAL FORWARD, it has to be taken as a complement instead.
  199.  
  200.    It's still required some considerable experimentation effort and fine
  201. tunning over the program algorithms to improve the capture efficiency;
  202. preliminar figures shows a capture efficienty between 10-60% on a W0RLI
  203. type of forward (ASCII non-compressed) and 5-50% on a F6FBB (binary,
  204. compressed) forward.
  205.  
  206.    The above ranges assumes a good electrical visibility between the
  207. monitoring station and both stations been monitored; figures could be
  208. even higher under good conditions.
  209.  
  210.    The criteria and program philosophy is to provide some savings at
  211. a very low execution cost in resource terms; so, if a single message is
  212. captured thru this way it could be considered a saving on future bandwidth
  213. usage.
  214.  
  215. Operations
  216. ----------
  217.    To understand the program operation a reasonable understanding of the
  218. AX.25 protocol is required.
  219.  
  220.    The program monitors the traffic on the channels visibles at a node,
  221. usually working under a G8BPQ NET/ROM switch altrough a posibility exists
  222. to operate it directly with a TNC (ver TFPCX).
  223.  
  224.    It's assumed that the program will run concurrently with some BBS or PMS,
  225. and potentially other components sharing the switch; this makes mandatory to
  226. run it on a multitasking environment. This requirement could only be avoided
  227. if the program run exclusively on a node, but this scenario it's very
  228. unlikely on practical terms.
  229.  
  230.    Since the program runs on DOS and the G8BPQ switch provides support for
  231. the industry most relevant multitasking environments it's likely to expect
  232. it will operate satisfactory on many of them.
  233.  
  234.    In quiescent state the program simply monitors the channel traffic without
  235. reacting to it, except when the monitor of the traffic is activated.
  236.  
  237.    To start the monitoring of a pair of nodes both the nodes address
  238. (callsign plus SSID) and the forward method (W0RLI or F6FBB) must be
  239. configured by the sysop; the program itself will not define that.
  240.  
  241.    The monitor of the activity between the defined link pairs will continue
  242. without effect until a mail 'proposal' consistent with the forward method
  243. informed is detected. Usually that means a FA/FB command for F6FBB and
  244. SP/SB for W0RLI.
  245.  
  246.    Once triggered by the proposal the program will start to follow the
  247. frame sequence being interchanged by both nodes under the AX.25 protocol
  248. guidelines trying to intercept and interpret those frames that could be
  249. validated as correct, from the intercepted frames only those with information
  250. are relevant altrough all of them are verified with flow control purposes.
  251.  
  252.    The resulting captured information, free of control codes, are stored
  253. using an import format to be able to feed them into the local BBS/PMS later;
  254. the used format is basically an ASCII text file delimited by the forward
  255. command (SB/SP) and an end of message marker (/EX).
  256.  
  257.    Once the message end is detected (or the sequence is lost) the program
  258. fall back to monitor the traffic between both nodes trying to catch the next.
  259.  
  260.    Not all the AX.25 protocol is followed; the program mimics a TNC only
  261. partially, only relevant frames are decoded.
  262.  
  263.    In case the sequence followed shows that some information were lost the
  264. program activates algorithms to start a recovery process of the sequence;
  265. if the action is successfully completed the message capture will continue
  266. otherwise the message is completely lost.
  267.  
  268.    As an example, if the sequence shows a frame has been missed the program
  269. logic wouldn't interrupt the message capture until be sure the receiver node
  270. for that frame didn't lost the same frame too; if the receiver had the same
  271. problem (i.e. a collision) the receiver TNC will start the protocol
  272. correction and retry handshake leading eventually to the missed frame to
  273. be resent.
  274.  
  275.    However, when a frame is positively lost the complete message is lost;
  276. if the link is operating using a batch message forwarding process it's
  277. also probable for the rest of the messages in the batch to have some problems;
  278. the logic tries usually to recover from that, but the degree of success is
  279. quite variable.
  280.  
  281. Monitoring Slots
  282. ----------------
  283.  
  284.    The program is able to monitor up to 5 link pairs simultaneously using
  285. each one their own transfer protocols (FBB o RLI).
  286.  
  287.    Each channel or link pair is referred as a 'slot' through this document.
  288.  
  289.    The stations associated with each slot and the forward method used by
  290. them are configured on the file PESCADOR.CFG and could be temporarily
  291. altered at execution time using the F7 key.
  292.  
  293.    It's on the sysop care not to assign the same stations (callsign and SSID)
  294. pairs to different slots (including using different protocols) because that
  295. will drive unreliable and faulty behavior in the forward capture process
  296. (some of the frames will be captured by one slot and others by the other).
  297.  
  298. Installation
  299. ------------
  300.  
  301. The distribution file has to be decompressed using the ARJ utility on a
  302. directory where the program will be run (usually \PESCADOR), this isn't
  303. mandatory.
  304.  
  305. It's assumed a multitasker (if used) and the G8BPQ switch (or TFPCX) are
  306. already properly installed and working.
  307.  
  308. Then, to install the program the following steps has to be performed:
  309.  
  310.    - Decompress the distribution file, the included files are:
  311.  
  312.           PESCADOR.EXE      Main executable program.
  313.           PESCALZH.EXE      Auxiliar program.
  314.           PESCADOR.CFG      Configuration Example (G8BPQ).
  315.           PESCA.BAT         Execution batch example (G8BPQ).
  316.           PESCATFP.BAT      Execution batch example (TFPCX).
  317.           PESCATFP.CFG      Configuration example (TFPCX).
  318.           PESCADOR.INI      TFPCX configuration example.
  319.           PESCADOR.DOC      The Spanish version of the manual.
  320.           PESCADOR.ENG      The English version of the manual.
  321.           README.1ST        Release news.
  322.  
  323.    - RTFM, specially the README.1ST.
  324.    - Configure the PESCADOR.CFG file, use the example as a guideline.
  325.         Mandatory parameters are
  326.              MYCALL    STATION_A   STATION_B
  327.              SLOT
  328.    - Define a DOS session where the program will run (if using a multitasker).
  329.    - Configure the PESCA.BAT adapting it to your machine environment.
  330.    - Adapt the PESCAFWD.BAT procedure (mail import) to your BBS/PMS.
  331.    - Launch the program using PESCA.BAT.
  332.  
  333.  
  334. Configuration File (PESCADOR.CFG)
  335. ---------------------------------
  336.  
  337. Follows the description of the parameters available to customize the program
  338. behaviour, some parameters are mandatory and some optionals.
  339.  
  340. Mandatory parameters doesn't usually have a default value, omission lead
  341. to the program cancellation.
  342.  
  343. Some of the parameters values (both mandatory or optional) could be later
  344. modified during execution using the available commands; however, as this
  345. program will usually run unattended it's very important to pay due attention
  346. to the configuration process.
  347.  
  348. INTERFACE
  349.     It's the interface the program will use to establish a dialog with the TNC.
  350.     Options are BPQ or TFPCX, the first is assumed as default.
  351.     Example:
  352.            INTERFACE BPQ
  353.  
  354.  
  355. MYCALL (mandatory)
  356.  
  357.     This is the callsign of the local station, without SSID.
  358.     Example:
  359.            MYCALL    LU1BUV
  360.  
  361. HADDR  (optional)
  362.  
  363.     It is the hierarchical node address, default is none.
  364.     Example:
  365.            HADDR     #ADR.BA.ARG.SOAM
  366.     Note: The activation of the R: record generation activated by the RLINE
  367.           parameter requires this one.
  368.  
  369. BPQ_PORT (optional).
  370.  
  371.     This is the BPQ stream used by the program to monitor, default is stream 10.
  372.     This parameter is required only if working with the G8BPQ Switch.
  373.     Example:
  374.            BPQ_PORT  10
  375.  
  376. TFPCX_INTR (optional).
  377.  
  378.     Configure the interruption number used by the system to communicate with
  379.     the TFPCX driver.
  380.     Default is 253 (0xFD).
  381.     This parameter is only required when using the program using the TFPCX
  382.     driver, IT MUST BE INFORMED AS A DECIMAL NUMBER.
  383.     Example:
  384.            TFPCX_INTR  251
  385.  
  386. SLOT (mandatory)
  387.     Configure the callsigns being monitored on a given slot and the forward
  388.     protocol used for that.
  389.     Up to 5 of these parameters could be used, defining each one a slot
  390.     numbered from 0 to 4.
  391.     Format is:
  392.  
  393.             SLOT Slot#,Origin Station,Target Station,Forward Mode
  394.  
  395.     Where:
  396.          Slot#                               Slot number [0..4]
  397.          Origin Station, Target Station      Stations to monitor.
  398.          Forward Mode                        Protocolo [FBB..RLI]
  399.  
  400.     The stations must be informed with SSID, that is, as they show
  401.     monitoring the channel.
  402.     If the forward takes place using a NET/ROM circuit the L4 callsign
  403.     must be indicated and not the L2 callsign.
  404.     This instruction set doesn't have defaults, if not configured no
  405.     monitoring will take place.
  406.     If a slot is informed more than once the last informed will be
  407.     retained.
  408.  
  409.     Example:
  410.  
  411.             Slot     1,LU9DGN,LU5DWT,FBB
  412.  
  413.  
  414.  
  415. LOG (Optional)
  416.  
  417.     Activates the monitoring activity to be reflected on the logging
  418.     file named PESCADOR.LOG.
  419.     The logging will reflect the content of the online monitoring activated.
  420.     Default is OFF (no logging).
  421.     Example:
  422.            LOG       ON
  423.  
  424. LOGFILE (Optional)
  425.  
  426.     This parameter configures the file where the logging will take place
  427.     if activated.
  428.     As a default this file is named PESCADOR.LOG; it could be useful
  429.     to assign a different name if more than one instance of the program
  430.     is run at the same time.
  431.  
  432.     Example:
  433.            LOGFILE   C:\PRUEBA.LOG
  434.  
  435.  
  436. MONITOR (Optional)
  437.  
  438.     Configure the starting monitoring detail level, the detail will vary
  439.     between level 0 (no monitoring), 1 (headers only) and 2 (headers+info).
  440.  
  441.     Example:
  442.            MONITOR   0
  443.  
  444. TRACE (Optional)
  445.  
  446.     Configure the trace detail level, the detail will vary between
  447.     level 0 (no trace), 1 (logic flow) or 2 (flow+info).
  448.  
  449.     This option is only useful for debugging purposes.
  450.  
  451.     Example:
  452.            TRACE     1
  453.  
  454. PRIVATEMAIL (Optional)
  455.  
  456.     Configure if private messages are exported, default is ON (yes).
  457.  
  458.     Example:
  459.            PRIVATEMAIL   OFF
  460.  
  461. RLINE (Optional)
  462.  
  463.     Configures if an R: record has to be added to captured messages as
  464.     if captured thru conventional forward.
  465.     Default is OFF, if activated requires the configuration of the
  466.     HADDR parameter.
  467.  
  468.     Example:
  469.            RLINE     ON
  470.  
  471. EXPORTTIME     (Optional)
  472.  
  473.     Configures the elapsed, in minutes, between the sucessive executions
  474.     of the export procedure (PESCAFWD.BAT).
  475.  
  476.     Example:
  477.            EXPORT    60
  478.  
  479. EXPORTFILE    (Optional)
  480.  
  481.     Configures the path and name of the file where the messages will be
  482.     exported.
  483.     The default name is PESCADOR.FWD and will reside at the same path
  484.     the program is executed from.
  485.  
  486.     Example:
  487.            EXPORTFILE   \TSTHOST\PESCADOR.IN
  488.  
  489. VIDEO      (Optional)
  490.  
  491.     If difficulties are experienced with the program display, usually
  492.     shown as a black or empty screen under an otherwise normal operation,
  493.     it could be produced by a video mode conflict.
  494.     As a default a color adapter is assumed (VIDEO COLOR), if irregular
  495.     behaviour is detected try VIDEO MONO.
  496.  
  497.     Example:
  498.  
  499.            VIDEO      MONO
  500.  
  501.  
  502. ERRORMAIL  (Optional)
  503.  
  504.     This parameter configure is marginal mail captured with uncertainity
  505.     about it's integrity has to be captured or not.
  506.     This parameter has only trascendence capturing a batch forward
  507.     protocol such as the FBB where a hit on a single mail could destroy
  508.     the whole batch capture.
  509.     The default value is active (ON), see the 'Mail Marginal' section for
  510.     operation details.
  511.  
  512.     Example:
  513.            ERRORMAIL   OFF
  514.  
  515. ERRORFILE  (Optional)
  516.  
  517.     Configures where the marginal mail intercepted when the ERRORMAIL
  518.     parameter is active is stored.
  519.     Default value is PESCADOR.ERR at the same path where the program is
  520.     executed from.
  521.  
  522.     Example:
  523.            ERRORFILE   PRUEBA.ERR
  524.  
  525.  
  526. PESCA.BAT File
  527. --------------
  528.  
  529.    This batch file is an example on how the program could be started,
  530. it's use is recommended and a customization to the local execution
  531. environment is required.
  532.  
  533. PESCAFWD.BAT File
  534. -----------------
  535.  
  536.    This batch file is called internally by the program to transfer the
  537. captured mail at regular intervals into the BBS/PMS automatically.
  538.  
  539.    The regular intervals are governed by the parameter EXPORTTIME, if
  540. 0 this procedure isn't executed.
  541.  
  542.    Configuration to the BBS/PMS used is required, the batch has to work
  543. in a way that the content of the PESCADOR.FWD file is dumped into other file
  544. where the BBS/PMS will take the export from.
  545.  
  546.    Once dumped the PESCADOR.FWD file must be erased; the main program will
  547. guarantee this file isn't in use when the external procedure is called.
  548.  
  549. Program Operation
  550. -----------------
  551.  
  552. The program could be executed from the DOS prompt or from a batch file
  553. such as the one provided as example (PESCA.BAT).
  554.  
  555. At the start the execution behaviour is dictated by the parameters
  556. indicated as execution switches or by the actual content of the PESCADOR.CFG
  557. file.
  558.  
  559. The format is:
  560.  
  561.               PESCADOR [-c ConfigFileName | ? ]
  562.  
  563. Where:
  564.  
  565.    -c ConfigFileName
  566.  
  567.       This parameter could be used to specify a configuration file
  568.       different from the default (PESCADOR.CFG).
  569.       It could be useful if a test configuration is generated or if
  570.       several instances of the program are run at the same time.
  571.       If a configuration file isn't found the program aborts execution.
  572.  
  573.    -? Execution Help.
  574.       A short help message is printed, the execution is stopped.
  575.  
  576. Execution
  577. ---------
  578.  
  579.    This program is designed to be run on a multitasking environment as
  580. a 'partner' of a BBS/PMS saving channel bandwidth on those messages
  581. that could be captured by simply monitoring of the channel.
  582.  
  583.    A particular case, covered later, when the program runs under TFPCX
  584. is an exception to the above scenario.
  585.  
  586.    The machine resources taxed by the program are modest; 150 to 200K of
  587. RAM memory are occupied by the program. Probably a 256 to 384K window
  588. should be enough.
  589.  
  590.    IMPORTANT, if the program works normally but fails to export at
  591. periodic intervals the captured mail it could be from a lack of memory
  592. to launch the PESCAFWD.BAT procedure, try increasing the RAM memory
  593. available to the program.
  594.  
  595.    It's convenient to launch the program using a procedure such as the
  596. provided PESCA.BAT with the proper customization to the local environment.
  597.  
  598. The batch PESCA.BAT will usually run thru the following steps:
  599.  
  600.    1) DOS environment definition (such as PATHS or video modes).
  601.    2) Some sort of TAME program (which is optional, but convenient).
  602.    3) Load of FOOLBPQ (necessary when running G8BPQ under OS/2 only).
  603.    4) Default execution of PESCADOR.EXE.
  604.    5) End of execution, handling of abnormal terminations.
  605.  
  606. Each one knows what his machine has and how far it could be pushed with
  607. additional load; in my case the program runs on a 386SX 16 Mhz Intel box
  608. under OS/2 at the same time than TSTHOST and JNOS without a noticeable
  609. degradation; on bigger/faster machines the operation should be even more
  610. unnoticeable.
  611.  
  612. A reasonable multitasking environment couldn't be established on older
  613. machines (such as ATs or XTs) so the program probably isn't well suited
  614. for them in real world terms, it would run though.
  615.  
  616.  
  617. OnLine Commands
  618. ---------------
  619.  
  620. At the execution start the program will use the configuration indicated
  621. at the PESCADOR.CFG file to define it's operational behaviour.
  622.  
  623. Some configuration could be performed using online commands.
  624.  
  625. F1 - Help.
  626.      Shows a summary of the available commands.
  627.  
  628. F2 - Application Monitoring.
  629.      Defines the level of the monitoring being performed.
  630.      Sucessive activation lead to the level Off (no monitoring), On
  631.      (General monitoring) and Inf (Detailed monitoring).
  632.      Monitoring will be filed also at the log if enabled.
  633.  
  634. F3 - Channel Monitoring.
  635.      Defines the level of detail on the information at the AX.25 protocol
  636.      (channel activity) level.
  637.      Sucessive activation cycles the level between Off (No monitoring),
  638.      On (General or CallSign monitoring) and Inf (Detailed Monitoring).
  639.      Monitoring will be filed also at the log if enabled.
  640.  
  641. F4 - Export
  642.      Will execute the PESCAFWD.BAT inmediately.
  643.      This command will be effective if the program is such an internal
  644.      state that safely allows the PESCADOR.FWD file (or equivalent) to
  645.      be manipulated (and IF it exist).
  646.  
  647. F5 - Reset Sesion
  648.      Reset the slot individually to a idle condition.
  649.  
  650. F6 - Error Mode.
  651.      Enable or Disable the capture of marginal mail into an error file
  652.      (PESCADOR.ERR or equivalent).
  653.  
  654. F7 - Slot Edit.
  655.      Enable the editing of the slots (stations and forwarding protocol).
  656.      The modified slots will be reset prior to use.
  657.      Modifications thru this command has the lifespan of the current
  658.      execution because they are not reflected on the configuration file.
  659.  
  660. F9 - Session Logging.
  661.      Cycles the logging On and Off, each time the logging is cycled from
  662.      Off to On the existing file is also erased.
  663.  
  664. F10- DOS Gateway
  665.      Allows a DOS shell to be activated, while active the monitoring
  666.      is STOPPED.
  667.  
  668. a-Q  End of Execution (Alt+Q).
  669.      Unconditionally ends the execution.
  670.  
  671.  
  672. Use of the captured traffic.
  673. ----------------------------
  674.  
  675.    As explained before the mail successfully captured is stored on the
  676. PESCADOR.FWD file as an W0RLI import, this format is accepted widely
  677. on most packet BBS as a way to import messages.
  678.  
  679.    This file has to be, at regular intervals, feed into the BBS/PMS to
  680. load the messages on it. This process could take place either regularly
  681. or during some maintenance cycle of the BBS/PMS.
  682.  
  683.    A balance has to be exercised on this load; too frequently will end up
  684. interfering with the capture process itself.
  685.  
  686.    Too sporadic and the mail will arrive thru normal forwarding before it
  687. has the opportunity to be feed into the BBS/PMS; a balance has to be
  688. judged by the sysop based on his operational pattern.
  689.  
  690.    An import each hour seems to be a good balance on most cases.
  691.  
  692.    Please note that the capture is basically a blind process, the same
  693. message could be captured several times on different slots and even a
  694. message already at the local BBS could be captured; however, it's assumed
  695. that the BID control mechanisms on the BBS/PMS will filter those duplicates.
  696.  
  697. TFPCX Operation.
  698. ----------------
  699.  
  700.    The program peak benefit is obtained operating it as a BBS/PMS partner.
  701.  
  702.    That implies the simultaneous operation under a multitasking environment
  703. and some means to share the hardware (ports and TNC), such as the G8BPQ switch.
  704.  
  705.    There are scenarios where it might be apropriate to run the program off
  706. from this concept, using a dedicated TNC and port as an example.
  707.  
  708.    This would usually be a test scenario, such as when a quick evaluation
  709. ir required without the complexity of a full installation and configuration.
  710.  
  711.    To cover that, the capability to use TFPCX as a driver with the TNC is
  712. provided; to install the program in this way proceed as follows:
  713.  
  714.      1) Install the TFPCX Version 2.1 driver or later.
  715.      2) Configure the driver using PESCADOR.INI as a template.
  716.      3) Configure the program, you could use PESCATFP.CFG as a template.
  717.      4) Launch the program as indicated on the example PESCATFP.BAT.
  718.  
  719. Legal and Ethics.
  720. -----------------
  721.  
  722. Some sysops could question the whole legal base for this program, after all
  723. it's able to capture mail from other stations without their consent, even
  724. without their knowledge.
  725.  
  726. Each country will have his legal scenario I am not able to talk over, each
  727. sysop must seize it.
  728.  
  729. In my own country, which in many respects follow the trends set by the
  730. FCC regulations, the usage is perfecly legal.
  731.  
  732. Since the system is completely pasive (it don't transmit) I think it's
  733. even legal to be used by SWLs and amateurs without license!!
  734.  
  735. However, even closing the legal issues some sysops could raise some issues
  736. regarding the ethics of the message interception.
  737.  
  738. From it's the author point of view that a bulletin is publicly being
  739. transferred on a open network under a known capability of many other stations
  740. to monitor that transfer; the bulletin originator itself has no knowledge
  741. of the forward process of it's own material once it's on the net.
  742.  
  743. Private mails are, under the author's opinion, on a similar conceptual
  744. framework. However, a more 'touchy' esence is recognized on this case.
  745.  
  746. If the sysop feels the capture of the private mail is in contradiction with
  747. his/her policy it could easily avoid that capture with the PRIVATEMAIL OFF
  748. configuration sentence.
  749.  
  750. Operation Notes
  751. ---------------
  752.  
  753. The program capture efficiency will vary depending on several factors, such
  754. as:
  755.  
  756.    - Quality of reception of the intercepted nodes with us.
  757.    - Quality of reception of the intercepted node between them.
  758.    - Channel activity and colission level.
  759.    - Activity being generated by our local BBS/PMS on the monitored channel.
  760.    - Message size.
  761.  
  762. The capture proficiency, expressed as messages successfully captured over
  763. total messages interchanged on a given link, deteriorates very quickly with
  764. a decreasing reception quality and with channel activity.
  765.  
  766. Also, the proficiency degrades very sharply as the average size of the
  767. messages being forwarded increases; this is reasonable since as the message
  768. length increase the probability of a hit on it increases too.
  769.  
  770. The capture is degradated by a local activity at the BBS/PMS on the
  771. monitored channels; this is because our own BBS/PMS will prevail on
  772. colissions with other stations, including the ones being monitored.
  773.  
  774. A reasonable expectation should be set on a capture in the order of 5 to
  775. 50% on FBB monitored links and somewhat higher on RLIs, this is because
  776. on RLIs a single hit impacts a single message while on FBBs a single hit
  777. could destroy several messages on the batch.
  778.  
  779. The efficiency will vary, tipically, with the hour. This is because as
  780. peak activities occurs less messages will be captured, peak activity
  781. occurs usually at given hours on a given channel.
  782.  
  783. However, a global proficiency increase could be achieved with the
  784. simultaneous monitoring of several link pairs, specially if the forward
  785. is common to all BBS on the area.
  786.  
  787. Thus, a message lost due to some problem on a link could be captured on
  788. another; as a counterbalance it's very likely to capture a given message
  789. twice.
  790.  
  791. Out of experimentation, the proficiency rises a 50% by each link
  792. monitored, in other words it three nodes with low proficiency are monitored
  793. such as:
  794.  
  795.           Enlace A-B      9%
  796.           Enlace A-C     12%
  797.           Enlace C-H      8%
  798.  
  799. The overall proficiency will be in the order of 20%; this value increases
  800. noticeably as soon as the monitored links increases the individual
  801. proficiency, as an example:
  802.  
  803.           Enlace A-B     15%
  804.           Enlace A-C     25%
  805.           Enlace C-H     18%
  806.  
  807. Will yield a total proficiency of about 40%, which is by all means
  808. significative in terms of bandwidth savings because of lack of forward
  809. (our node will look to the network as using only 60% of the usual bandwidth
  810. for forwarding purposes!!!).
  811.  
  812. Dara una eficiencia total del orden del 40%, lo que es significativo en
  813. terminos de forward adicional que se evita con nuestra estacion.
  814.  
  815. Estos guarismos seguramente variaran en otros escenarios de forward
  816. distintos a los que se ha experimentado el programa hasta el momento.
  817.  
  818. As a general concept, consider this program as less proficient than your
  819. own station performing connected transfers, if you experience problems
  820. even on connected links (such as collisions, retries, hidden terminal
  821. effects, etc) this program will be impacted even greatly because it lacks
  822. the protection for fault recovery provided by the AX.25 protocol on
  823. connected mode.
  824.  
  825. Further from this point no theory is available, just try it and bring up
  826. your own conclusions!
  827.  
  828. Mail Marginal
  829. -------------
  830.  
  831. Whenever a L2 AX.25 problem is detected (such as the complete lost of
  832. a whole frame) the message being received is abandoned because it's
  833. integrity couldn't be reasonably guaranteed (we don't have a way to
  834. guess how important is the missed frame).
  835.  
  836. On a RLI protocol forward this message is gone and the program prepares
  837. itself for the next one.
  838.  
  839. However, on FBB protocol forwards messages comes in batches, an error
  840. during the reception of a message impairs the whole batch (worst case
  841. is when the frame contains the end of a message and the start of the
  842. next).
  843.  
  844. The program in such cases activates an algorithm that explore the binary
  845. transfer itself and tries to sync with the start of a new message, this
  846. is called SmartSync, and if the message is successfully captured it's
  847. stored.
  848.  
  849. A similar case occurs when the lost frame is the answer of a proposal
  850. (then we don't have the foggiest idea about the message sequence as
  851. sent by the sender); the message itself could be flawlessy captured but
  852. the program couldn't associate them with the apropriate header (then
  853. the program don't know to who the message is sent, who originated it
  854. and it's BID).
  855.  
  856. On both cases, and if the ERRORMAIL parameter is ON, the message is
  857. exported on a special file named PESCADOR.ERR as a private mail
  858. directed to the sysop and from the sysop.
  859.  
  860. Before being exported, the message itself is scanned, and all the
  861. information that could be rebuilt from the message itself (such as
  862. R: records or 'From' or 'To' sentences) will be used to reshape the
  863. origin or destination of the mail as well as it's bid.
  864.  
  865. The quality of those messages is much lower than the ones guaranteed by
  866. a flawlessy capture with all the guards of the AX.25 protocol so they aren't
  867. imported automatically on the BBS/PMS by the PESCAFWD.BAT procedure; the
  868. sysop has to decide if he wants to manually inspect or correct the message
  869. and import them or just discard the whole marginal capture.
  870.  
  871. Final
  872. -----
  873.  
  874. This section has a disproporcionate size with the description of the
  875. program; but I have years teaching me that this program will contact
  876. me with a majority of wonderful people and with few idiots, thefts and
  877. crazy guys.
  878.  
  879. If you feel you belong to the first category please don't bother by
  880. the following paragraphs, they're not for you; if you feel you could
  881. qualify to the second perhaps you'll do a bright thing not using this
  882. program in the first place.
  883.  
  884. The usual stuff, the program has been tested and works reasonably within
  885. the documented behaviour, but any failure or damage caused by its operation
  886. is beyond my responsibility. Use it at your own risk.
  887.  
  888. As often stated: 'The only thing I guarantee regarding this program it that
  889. it will use some of your disk space'.
  890.  
  891. This program has been written for a radioamateur, for radioamateurs on
  892. radioamateur uses; within those limits use the program as it best suit
  893. your wishes for no charges or fees. However, I do retain the full
  894. copyright on the program and you don't have any legal right on it.
  895.  
  896. You're expected to cease on the program utilization at the first formal
  897. notification you receive, if you don't share this condition just don't
  898. use the program.
  899.  
  900. Please, take into consideration this is a BETA version of the program
  901. released with the purpose of an open evaluation and feedback.
  902.  
  903. I did invest a considerable amount of my own time in the study, design,
  904. build and test of this program; I really enjoyed the experience (and
  905. the learning) I got from it and I don't expect your thanks.
  906.  
  907. However, I do expect you to be kind and constructive on any comment you
  908. dare to send to me on the program; if you're tempted to send other kind
  909. of comment just don't waste your time nor mine.
  910.  
  911. It's IMPOSSIBLE to verify and test all possible hardware and software
  912. configurations in operations out there, I don't discard conflicts between
  913. this program and others, so if you report an error to me please give me
  914. a reasonable description on the how, when, wheres of the environment
  915. in which this program is intended to be run.
  916.  
  917. I usually do honor my mail reasonably fast, but be reasonable yourself
  918. and please remember that this is a hobby to me (like it's to you) and
  919. I might have other priorities on a given momment that could make it
  920. difficult to me to answer mail on the expeditive way you might expect.
  921.  
  922. The support or any further update of this program could cease without
  923. previous notification.
  924.  
  925. This program is free for radioamateur purposes, it's commercial use is
  926. prohibited; it's distribution couldn't be charged except the nominal
  927. value of the recipient, the effort to record it and any distribution
  928. fee involved.
  929.  
  930. Comments and suggestions please directed to:
  931.  
  932.                 AX.25   : LU1BUV@LU1BUV.#ADR.BA.ARG.SOAM
  933.                 AMPR    : lu1buv@lu1buv.ampr.org
  934.                 Fido    : Pedro Colla @ 4:901/267
  935.                 Internet: colla@pec.pccp.com.ar
  936.  
  937.